                  
                  MODIFYING AND CREATING LESSONS


Lesson Names

     The lessons sounded by the program are DOS Text files, stored
in the Lessons directory. The name of a lesson is dependant apon which
program is is targeted, MKLESSON.n is for Morse Keyboard, MTLESSON.n
is for Morse Transmit and MSLESSON.nn is for Voice Morse. Where n is
an integer number.


Lesson Codes

     Codes are used within each lesson to set the speed of the
morse, time delay between symbols, lesson passmark, to introduce
symbols and to display messages to the user.  Following is an
explanation of the codes used and an example (MKLESSON.1):


Text Codes     Explanation

~              Tilde - indicates the START and END of text to be
               displayed to the user. Other codes may also be used
               within the tildes.  When a tilde is encountered the
               cursor will be moved to the top left corner of the
               Text Box (See example next page).

@h or @H       High Text Colour (Yellow) - The text after this code
               will be yellow.

@l or @L       Line Feed - Forces a line feed, used to format the
               text within the Text Box.

@n or @N       Normal Text Colour (White) - The text after this code
               will be low intensity white.

@p or @P       Prompt - Writes the prompt "Press any Key..." on the
               screen and waits for the user to press a key before
               program execution continues.

@r or @R       Remove - Clears the Text Box, any text displayed will
               be removed.

@w or @W       Wait - Wait 1 second before continuing, delays
               program execution.


Morse Codes    Explanation

[]             Square Brackets - Enclose symbols to be formally
               introduced at the start of a lesson, a maximum of 10
               symbols may be inserted. 

@Cnnn          Character Delay - Delay between symbols in 1000ths of
               seconds.

@Dnn           Dit Speed in Words Per Minute. 
               
@Pnn           Passmark - Sets the percentage passmark for the
               lesson.   

@V             Voice On, for VOICE MORSE LESSONS only, phonetic name 
               of symbol is pronounced after sounding if this switch
               is included.

Lesson Codes Example

NOTE:     The curly brackets are used to enclose explanation remarks
          and are not part of the normal lesson.

~         {Start of message to display to user}
@h        {Use High text colour - Yellow} 
                               LESSON 1 
@w@w@w    {Wait for 3 seconds}
@r        {Remove message}
~         {End of message}
@P75      {Set Passmark at 75%}
@D20      {Set symbol speed to 20 wpm} 
@C400     {Set delay between characters to 4 seconds} 
 
[PULXYF]  {Symbols to be introduced}
 
PPUULLXXYYFFXFLYXPULPXYPF  {Morse Symbols to be sounded}
PLLYFFXUUXLPYFPYFLUXYYXFX 
FFYYXXLLUUPPLPUXPUYFFYXLL 
XFPYUXYFLUXYFPULPXYPFPXFF 
~         {Start of Message to user}
@w@w      {Wait 2 seconds}
@r        {Remove morse run from screen / clear screen}
@h        {Use High text colour}
@l@l@l    {Three line feeds}
                           END OF LESSON 1 
@w@w@w    {Wait 3 seconds}
@r        {Remove message from screen}
~         {End of Message}


     The above example is the first lesson encountered when running
Morse Keyboard. For an insight into formatting a lesson attempt
lesson 1.  Later lessons contain more complex examples of the use
of codes.





